home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / wb / czesc_2 / ml / man / dos / execute < prev    next >
Text File  |  1993-01-23  |  3KB  |  67 lines
  1. EXECUTE(1)                      DOS COMMANDS                      EXECUTE(1)
  2.  
  3. NAME
  4.      EXECUTE : To execute a command file with argument substitution.
  5.  
  6. SYNOPSIS
  7.      EXECUTE <command file> [{arguments}]
  8.  
  9. TEMPLATE
  10.      EXECUTE "COMMANDFILE,ARGUMENTS"
  11.  
  12. PATH
  13.      C:
  14.  
  15. DESCRIPTION
  16.            EXECUTE executes a command (script) file. The command file can
  17.      give special directives to EXECUTE by starting a line with special
  18.      keywords.
  19.  
  20.            The syntax off a script file is as follow:
  21.      A keyword always starts a line and starts with a dot (.):
  22.      .KEY (or .K)  Argument template. The parameters as specified by a list
  23.           of keyword names separated by commas. The names can be followed by
  24.           a slash(/) and a letter:
  25.           /A : the variable must be supplied.
  26.           /K : the variable is optional.
  27.           /F : final argument. The variable contains the rest of the
  28.                command line.
  29.           /S : switch. The variable contains the argument name if the switch
  30.                is set, or is empty if it is not.
  31.  
  32.      .DOT ch : change the DOT char (.) to ch.
  33.      .BRA ch : change the BRA char (default "<") to ch.
  34.      .KET ch : change the KET char (default ">") to ch.
  35.      .DOLLAR ch : (or .DOL) change the default-char (default "$") to ch
  36.      .DEF    : keyword value Give default to parameter.
  37.      .<space> : Comment line
  38.      .<new line> : blank comment line.
  39.      .\ A blank remark. 
  40.  
  41.            Before execution, AmigaDOS substitutes any items enclosed by BRA
  42.      and KET ("<" and ">"). Such items can consist of one keyword or one
  43.      keyword and a default value for AmigaDOS to use if the keyword is unset.
  44.      The keyword and the default value must be separated by the default-char
  45.      ($ by default). For example, <myvar$MyDefault> will become the value of
  46.      myvar if var is set, and MyDefault if it isn't.
  47.  
  48.            If the file does not start with a DOT (.) AmigaDOS assumes that
  49.      there is no other DOT keyword in the file.
  50.      If they are DOT keyword in the files, the file is copied into the
  51.      logical directory T: (if it is ASSIGNed) or into the T directory.
  52.  
  53.            The CLI number can be referred to by the characters <$$>.
  54.      All information after the ";" character on a line is ignored. This
  55.      is one way to insert comments into a command file.
  56.  
  57.            If the "s" bit of a command line is set, the file can be executed
  58.      by entering the name of the file on a CLI or SHELL. (The file must
  59.      be in a directory belonging to the PATH.) So, if the "s" bit of
  60.      MyCom is set, "MyCom" is equivalent to "EXECUTE MyCom".
  61.  
  62. SEE ALSO
  63.      ASSIGN, PROTECT. 
  64.  
  65. EXAMPLE
  66.      > EXECUTE MySript My_Argument
  67.